home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / compress / stzip / stzip.doc < prev    next >
Text File  |  1984-01-31  |  28KB  |  662 lines
  1.  
  2.  
  3.  
  4.   ____________________________
  5.                            _________  ***** ******    ******  *  *****
  6. __________________________           *        *         **   *  *    *
  7.                     _________________ **     *       ***    *  ******
  8.   ________________                     *   *      **      *  *
  9.                     _____________ *****   *      ******  *  *
  10.      ______________________
  11.  
  12.  
  13.  
  14.  
  15.                             STZip version 2.6
  16.                        (c) Vincent Pomey 1990-1994
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.         **************
  25.         * 0 - Prolog *
  26.         **************
  27.  
  28.     STZip is a program that allows you to compress and decompress
  29. files, i.e.  to reduce their lengths. You saves space on your disks and
  30. reduce the transmission time if you send the files by modem. It also
  31. allows you to group several files in one single file, whose extension
  32. in general is ZIP.
  33.  
  34.     STZip uses files that are compatible with PKZip 2.04 on the IBM PC,
  35. and the Unix Info-Zip programs Zip 1.9/Unzip 5.0.
  36.  
  37.     You may copy this program and put it for download on bulletin
  38. boards. Commercial use and distribution (that includes putting STZip or
  39. self extracting files made by STZip on anything that is sold for more
  40. than the cost of the disk and handling charges) is not authorized without
  41. agreement of the author. You use this program at your own risk, there
  42. is no warranty.
  43.     Please avoid to "repackage" STZip, I prefer than the users gets all
  44. the files originally in the distribution.
  45.  
  46.     This is postcardware : if you use it, please register by sending a
  47. postcard to
  48.  
  49. Vincent Pomey
  50. 2 allée Valéry Larbaud
  51. 92260 Fontenay aux roses - France
  52.  
  53.     I inform registered users of new versions if they supply an E-mail
  54. address. Thanks to all users who were kind enough to register !
  55.  
  56.     The program is written in Modula-2 and assembler. For information
  57. on the file format, see the APPNOTE.TXT file distributed with PKZip from
  58. PKWARE. It explains the directory structure of a ZIP file, and the
  59. decompression algorithm.
  60.  
  61.     I can be reached via electronic mail :
  62. Fido  : Vincent Pomey (2:324/101.10)
  63. Email : vincent@stell.frmug.fr.net    (please do not send large mails)
  64.  
  65.     As you will probably see if you read this doc, I'm not a good
  66. technical writer... Sorry for that !
  67.  
  68.  
  69.                               ----oooOooo---
  70.  
  71.  
  72. There are several ways to use STZip:
  73.  
  74.         - double-clicking STZIP.PRG, using the GEM-interface
  75.  
  76.         - installing it as an application in the desktop: click once on
  77. STZIP.PRG, choose from the Desktop's menus the entry "Install 
  78. Application," type ZIP and confirm. After this, you may save the
  79. desktop.  Now, to use ZIP you only have to double-click a file with the
  80. extension  .ZIP and you will find yourself in STZip, with GEM interface
  81. for using that file.
  82.  
  83.         - renaming STZIP.PRG to STZIP.TTP and using it (or ZIPJR.TTP)
  84. with a command  line.
  85.  
  86.         - from a command line interpreter or external program, also using 
  87. a command line.
  88.  
  89.         - with some desktops, it is possible to drag and drop a file to
  90. the STZip icon. If this is a zipfile, it will be opened. If not, a
  91. zipfile with a similar name (e.g. FLAP.ZIP if you dropped FLAP.PRG)
  92. will be opened.
  93.  
  94. The usage with the GEM interface is the easiest. Certain options are 
  95. available only in GEM (the comments for example), while others are only 
  96. present with command-line usage (e.g. excluding files from compression).
  97.  
  98. ZIPJR.TTP is a stripped down version of STZIP : it does not have code
  99. for the GEM interface, but features are exactly the same if you're
  100. using the command line interface. The only advantage is that it is
  101. smaller.
  102.  
  103.  
  104.  
  105.         *********************************
  106.         * I - Usage with a command line *
  107.         *********************************
  108.  
  109. The usage of STZip with a command line is similar to that of ARC or LHArc 
  110. on the Atari, or PKZip on the PC.
  111.  
  112.  
  113.    1 -  A Table
  114.    ------------
  115.  
  116.  
  117.    +--------------------------------------------------------------------+
  118.    |       The syntax is of the form:                                   |
  119.    |                                                                    |
  120.    |    STZip command {options} [path] zipfile {file}                   |
  121.    |                                                                    |
  122.    |                                                                    |
  123.    |  There has to be one single command:                               |
  124.    |                                                                    |
  125.    |    -a      add files                                               |
  126.    |    -d      delete files                                            |
  127.    |    -f      freshen: update files in the zip-file                   |
  128.    |    -u      update: add new files and freshen the ones already      |
  129.    |            present in the zip-file                                 |
  130.    |    -x      extract files                                           |
  131.    |    -s      extract compressed files on the screen                  |
  132.    |    -c      check the zipfile                                       |
  133.    |    -v      list of the files with info                             |
  134.    |    -l      list of the files, just with their names                |
  135.    |    -?      a bit of help                                           |
  136.    |                                                                    |
  137.    |                                                                    |
  138.    |   You can also add a few options:                                  |
  139.    |                                                                    |
  140.    |    -o      overwrite a file without asking for confirmation        |
  141.    |            if the file already exists                              |
  142.    |    -r     `recursive compression: all the files in the             |
  143.    |            sub-directories you selected will also be compressed.   |
  144.    |           `recursive decompression: files compressed from sub-     |
  145.    |            directories will be decompressed in the corresponding   |
  146.    |            folders, which will be created if they don't exist.     |
  147.    |    -p      store pathname: the pathname of the file you have       |
  148.    |            specified in the command line is stored in the zip;     |
  149.    |            automatic with recursive compression                    |
  150.    |    -m      move file: files are deleted after compression          |
  151.    |    -t      the date of the .zip file will be that of the file      |
  152.    |            compressed with the most recent date.                   |
  153.    |    -z      modify the general comment for the zip file             |
  154.    |    -i dir  put the files to be compressed in the subdirectory      |
  155.    |            DIR in the zipfile                                      |
  156.    |    -b dir  use dir when writing tempo files                        |
  157.    |    -g      extract the file FFF.ZIP in the directory FFF           |
  158.    |    -w pw   encrypt the files to be added using pw as password      |
  159.    |            or use pw to decrypt the files to be extracted          |
  160.    |    -nmmddyy add only the files newer than mm/dd/yy (US date format)|
  161.    |    -h      wait for keypress before terminating the program        |
  162.    |    -k      filenames are case insensitive when using MiNT          |
  163.    |    -q      quiet - suppress all output                             |
  164.    |    -e      specifies the compression method:                       |
  165.    |             -es    store, no compression                           |
  166.    |             -eh    shrink, quick compression                       |
  167.    |             -ei    implode, default                                |
  168.    |             -ed    deflate, better compression                     |
  169.    |                                                                    |
  170.    +--------------------------------------------------------------------+
  171.  
  172. Note that you can use the -z option alone, without any command. STZip
  173. will only ask you for the new comment of the file.
  174.  
  175. The -k option is only useful